PUT Outstream Player

Overview

---

The following table contains important information about the PUT method for updating an outstream player.

PUT Outstream Player
Method	PUT
URL or Endpoint	/api/v1/projects/projectId/outstream-players
Headers	Authorization
Parameters	projectId
Body	Check request body below

The description of the URL parameter is as follows:

projectId URL Parameter
URL Parameter Name	projectId
Mandatory	Yes
Type	string
Description	Unique Id of the project

Request Body

{
  "publicId": "string",
  "name": "string",
  "responsive": true,
  "width": 0,
  "height": 0,
  "releaseChannelId": 0,
  "muteOnStart": true,
  "viewableThresholdPercentage": 0,
  "autoStartOnViewableOn": true,
  "autoPauseOnViewableOn": true,
  "volumeSlider": true,
  "playButton": true,
  "muteButton": true,
  "controlBarIconsDefaultColor": "string",
  "controlBarIconsHoverColor": "string",
  "controlBarSliderProgressColor": "string",
  "controlBarSliderRailColor": "string",
  "controlBarSliderDraggerColor": "string"
}

Information about the fields that appear when you type in the request body are displayed in the table below.

Field Name	Type	Mandatory	Description
playerId	string	Yes	The ID of the outstream player.
name	string	No	The name of the outstream player.
responsive	boolean	Conditional	If set to true, the player size will be responsive. In this case, width and height are not mandatory. If false, then width and height are required.
width	integer	Conditional	The width of the player in pixels. This field is mandatory if responsive is false.
height	integer	Conditional	The height of the player in pixels. This field is mandatory if responsive is false.
releaseChannelId	integer	No	The ID of the release channel used for the player version.
muteOnStart	boolean	No	If true, the player will start muted.
viewableThresholdPercentage	integer	No	The percentage of player viewability required to trigger viewable events.
autoStartOnViewableOn	boolean	No	If true, the player will automatically start when it becomes viewable.
autoPauseOnViewableOn	boolean	No	If true, the player will automatically pause when it is no longer viewable.
volumeSlider	boolean	No	Whether to display the volume slider control.
playButton	boolean	No	Whether to display the play button control.
muteButton	boolean	No	Whether to display the mute button control.
controlBarIconsDefaultColor	string	No	Color for control bar icons in default state.
controlBarIconsHoverColor	string	No	Color for control bar icons on hover.
controlBarSliderProgressColor	string	No	Color of the progress part of the control bar slider.
controlBarSliderRailColor	string	No	Color of the rail (background) of the control bar slider.
controlBarSliderDraggerColor	string	No	Color of the dragger (handle) on the control bar slider.

Response

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "publicId": "string",
    "name": "string",
    "responsive": true,
    "width": 0,
    "height": 0,
    "releaseChannelId": 0,
    "muteOnStart": true,
    "viewableThresholdPercentage": 0,
    "autoStartOnViewableOn": true,
    "autoPauseOnViewableOn": true,
    "volumeSlider": true,
    "playButton": true,
    "muteButton": true,
    "controlBarIconsDefaultColor": "string",
    "controlBarIconsHoverColor": "string",
    "controlBarSliderProgressColor": "string",
    "controlBarSliderRailColor": "string",
    "controlBarSliderDraggerColor": "string",
    "orderNumber": 0,
    "releaseChannel": {
      "id": 0,
      "name": "string",
      "originalPath": "string",
      "templateOriginalPath": "string"s
    }
  },
  "resultInfo": "string",
  "statusCode": 0
}

Information about the fields that appear when you receive the response are displayed in the table below.

Field Name	Type	Description
success	bool	If the response is successful, it returns true; otherwise, it returns false.
errors	array[]	Indicates if there was an error.
messages	array[]	Returns the response message from the back-end.
result	array[Object]	Returns the response object.
publicId	string	Public ID of the outstream player.
name	string	Name of the outstream player.
responsive	boolean	Specifies if the player layout is responsive.
width	integer	Width of the player in pixels (used when responsive is false).
height	integer	Height of the player in pixels (used when responsive is false).
releaseChannelId	integer	The ID of the release channel used for the player version.
muteOnStart	boolean	If true, the player starts muted.
viewableThresholdPercentage	integer	The percentage of player viewability required to trigger viewable events.
autoStartOnViewableOn	boolean	If true, the player will automatically start when it becomes viewable.
autoPauseOnViewableOn	boolean	If true, the player will automatically pause when it is no longer viewable.
volumeSlider	boolean	Whether to display the volume slider control.
playButton	boolean	Whether to display the play button control.
muteButton	boolean	Whether to display the mute button control.
controlBarIconsDefaultColor	string	Color for control bar icons in default state.
controlBarIconsHoverColor	string	Color for control bar icons on hover.
controlBarSliderProgressColor	string	Color of the progress part of the control bar slider.
controlBarSliderRailColor	string	Color of the rail (background) of the control bar slider.
controlBarSliderDraggerColor	string	Color of the dragger (handle) on the control bar slider.
resultInfo	string	Returns extra information about the result.
statusCode	integer	Returns the HTTP Status Code.

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

• HTTP Status Code 400: Bad Request

• HTTP Status Code 401: Unauthorized

• HTTP Status Code 403: Forbidden

• HTTP Status Code 404: Result Not Found

• HTTP Status Code 500: Internal Server Error

• HTTP Status Code 503: Backend Fetch Failed